TrueNAS Early Release Documentation
This content follows TrueNAS 25.10 (Goldeye) early release versions. Pre-release software is intended for testing purposes only.
Use the Product and Version selectors above to view content specific to a different software release.
- TrueNAS 25.10 (Early)
- /
- Getting Started
- /
- 25.10 (Goldeye) Version Notes
25.10 (Goldeye) Version Notes
15 minute read.
25.10 Early Release DocumentationThis page tracks the early release development for the future TrueNAS major version 25.10 (Goldeye). See the stable 25.04 (Fangtooth) release notes for information relating to that version.
Early releases are intended for testing and feedback purposes. Do not use early-release software for critical tasks.
August 28, 2025
The TrueNAS team is pleased to release TrueNAS 25.10-BETA.1! This first public release version of TrueNAS 25.10 (Goldeye) has software component updates and new features that are in the polishing phase.
Special thanks to (Github users): Aurélien Sallé, ReiKirishima, AquariusStar, RedstoneSpeaker, Lee Jihaeng, Marcos Ribeiro, Christos Longros, dany22m, Aindriú Mac Giolla Eoin, William Li, Franco Castillo, MAURICIO S BASTOS, TeCHiScy, Chen Zhaochang, Helak, dedebenui, Henry Essinghigh, Sophist, Piotr Jasiek, Martin Dørum, Emmanuel Ferdman and zrk02 for contributing to TrueNAS 25.10-BETA.1. Visit our guide for information on how you too can contribute.
TrueNAS Enterprise
Virtual Machines are now “Enterprise ready” with support for TrueNAS Enterprise High Availability (HA) systems and failover (NAS-136509).
Failover moves to the Advanced Settings screen (NAS-135469).
- Introduces a redesigned Updates screen that allows users to select an update profile reflecting their risk-tolerance level (NAS-133600). TrueNAS only notifies users of updates recommended for their selected profile level.
- Introduces changes to Certificates, Certificate Authorities (CA), and Certificate Signing Requests (CSR) (NAS-135168):
- Removes Certificate Authorities (CA) screens and support for CAs, which means you cannot sign CSRs or create self-signed certificates.
- Removes Add from Certificates. Users can import a certificate created by an external certificate authority.
- Allows adding a certificate using the new Create ACME Certificate screen found under Certificate Signing Requests and an existing DNS authenticator added through the ACME DNS Authenticators screen. See Preparing to Upgrade for more information.
- Introduces a refreshed Users (WIP) screen that provides improved, at-a-glance access to account information and simplified user creation (NAS-134198).
- Introduces changes to the Datasets and Storage Dashboard screens (NAS-135362, NAS-135364).
- Renames dataset and pool widgets, and changes links to other screens.
- Removes Scrub Tasks configuration and scheduling from the Data Protection Tasks screen, but makes it available on the Storage Health widget located on the Storage Dashboard (NAS-135555).
- Fixes the NVIDIA GPU related error “RenderError: Expected [uuid] to be set for GPU in slot” (NAS-134152).
- Includes the NVIDIA open GPU kernel module drivers. These drivers work with Turing and later GPUs. Earlier architectures (Pascal, Maxwell, Volta) are not compatible. See NVIDIA GPU Support for more information.
- Adds support for for directory services authentication via FTP (NAS-135200).
- Adds the Enable Secure Boot option to virtual machine configuration screens (NAS-136466).
- Allows TrueNAS to automatically migrate existing applications when selecting a new applications pool (NAS-132188).
- Adds TrueNAS Apps service support for configuring external container registry mirrors as alternative sources for Docker images (NAS-136553).
- Introduces various UI improvements and optimizations simplify core user experiences (NAS-135159).
- Includes critical ZFS stability fixes and performance improvements, including fixed corruptions for plaintext replication of encrypted snapshots, enhanced memory pressure handling, faster pool export operations, improved I/O scaling capabilities, zfs rewrite and Direct I/O support (NAS-135902).
- Simplifies and improves robustness of gateway and name server settings when changing from DHCP to static aliases (NAS-136360 and NAS-136360). Moves Network screen under the System main menu option.
- Fixes insufficient memory pressure on ZFS ARC by Virtual Machines to prevent out-of-memory conditions (NAS-135499).
- Virtual machines created in 25.04 (pre-25.04.2) and displayed on the Containers screen do not automatically start on system boot to prevent conflicts with VMs on the Virtual Machines screen that might use the same zvol(s) (NAS-136946).
- Makes changes to SMB shares:
- Enables access-based enumeration for SMB shares with NFSv4 ACL type, so directory listings only show files that users have permission to read (NAS-136499).
- Changes SMB share Advanced Options, Purpose, and Other Option settings associated with the preset setting selected (NAS-136499).
- Removes the AUTORID IDMAP backend option from Active Directory configuration to improve consistency across multi-server environments (NAS-136630). Existing configurations using AUTORID are automatically migrated to RID during upgrade. Users should review their ACLs and permissions after upgrade and might need to reconfigure them in some edge cases.
- Completes the transition to the versioned JSON-RPC 2.0 over WebSocket API by migrating all remaining jobs and events from the deprecated REST API (NAS-133984). Full removal of the REST API is planned for the TrueNAS 26.04 release.
- Removes the SMART UI (NAS-134927).
- Removes the built-in SMART test scheduling and monitoring interface to improve user flexibility while maintaining smartmontools binaries for continued third-party script compatibility (NAS-135020). Existing scheduled SMART tests are automatically migrated to cron tasks during upgrade, and users can install the Scrutiny app for advanced SMART monitoring.
- SMART tests functions no longer show on the Data Protections Tasks, Storage Dashboard, or individual disk screens.
See Preparing to Upgrade for more information.
- Improves drive temperature monitoring efficiency by extending the
drivetempkernel module to include SCSI/SAS disk temperatures. - Fixes an issue affecting drive temperature reporting on the dashboard (NAS-135572).
- Fixes a bug to reenable available update notifications for custom apps (NAS-135124).
- Fixes contrast issues on some UI theme options (NAS-135519).
Click here to see the full 25.10 changelog or visit the TrueNAS 25.10-BETA.1 (Goldeye) Changelog in Jira.
These are ongoing issues that can affect multiple versions in the 25.10 series.
When resolved, issues move to Notable Changes for the appropriate release.
An issue blocks some systems from upgrading (NAS-137352)..
During upgrades, 25.10 updates GRUB when it detects a version difference between the current and new GRUB. However, the code expects a BIOS partition to be present, so environments without a BIOS partition return a traceback. Systems initially deployed with TrueNAS SCALE have this partition, but some systems originally deployed with TrueNAS CORE can be impacted.
The time sort for frequency on the Cloud Sync Tasks screen is incorrect (NAS-137096).
Users page shows “can not retrieve response” due to invalid email address (NAS-137198).
The Virtual Machines page doesn’t refresh properly (NAS-136973).
See the latest status on Jira for public issues discovered in 25.10 that are being resolved in a future TrueNAS release.
See the Release Notes section of the TrueNAS forum for ongoing updates about known issues, investigations, and statistics about TrueNAS releases.
25.10 (Goldeye) brings many new features and improvements to the TrueNAS experience.
The Updates screen introduces risk-tolerance profiles for better control over system update notifications, while the refreshed Users screen provides improved account management with streamlined user creation workflows and better at-a-glance access to account information.
TrueNAS 25.10 introduces comprehensive networking enhancements designed for terabit Ethernet performance. NVMe over Fabric support includes NVMe/TCP for Community Edition and NVMe/RDMA for Enterprise hardware. RDMA capabilities eliminate TCP overhead and reduce latency for high-performance storage networking on Enterprise systems. Updated drivers provide 400GbE network interface support, while enhanced network configuration management improves robustness when transitioning between DHCP and static configurations.
TrueNAS 25.10 delivers comprehensive virtual machine enhancements including Secure Boot support for enhanced security and refined startup behavior to prevent conflicts between container and VM management interfaces.
Enterprise High Availability (HA) support enables seamless VM failover between cluster nodes.
Support for NVIDIA’s open GPU kernel module drivers enables compatibility with the latest graphics cards including the Blackwell architecture. Modern GPU acceleration capabilities are available for TrueNAS Apps and container workloads. See NVIDIA GPU Support for compatibility details.
Critical ZFS updates include stability fixes for encrypted snapshot replication, enhanced memory pressure handling, faster pool operations, improved I/O scaling, and new Direct I/O support for better performance in virtualized environments.
Automatic migration of existing applications when changing application pools eliminates manual reconfiguration and reduces downtime during pool transitions.
Early releases of a major version are intended for testing and feedback purposes only. Do not use early release software for critical tasks.
TrueNAS is an appliance built from specific Linux packages. Updating TrueNAS using
aptor any method other than the TrueNAS web interface can make the system inoperable.Modifying the base OS can cause unexpected behavior during upgrades:
Users who manually installed Docker on TrueNAS 24.04 or earlier can experience TrueNAS Apps failure in 24.10 or later.
This occurs due to conflicts between the manually installed and native Docker configurations.
- Affected systems can encounter
app_lifecycle.compose_actionerrors, such as:'group_add[0]' expected type 'string', got unconvertible type 'int', value: '568' - See NAS-134660 for details and a workaround.
- Affected systems can encounter
All auxiliary parameters can experience changes between TrueNAS major versions due to security and development changes. We recommend removing all auxiliary parameters from TrueNAS configurations before upgrading as these settings can result in unexpected behavior such as SMB share failures after an upgrade.
SSH auxiliary parameters are unsupported. Certain configurations can prevent the SSH service from starting.
After updating, clear the browser cache (CTRL+F5) before logging in to TrueNAS. This ensures stale data doesn’t interfere with loading the TrueNAS UI.
Application maintenance, including version updates, features, and configuration options, is independent from TrueNAS version release cycles.
See documentation and resources at the TrueNAS Apps Market and the truenas/apps repository issues tracker for more information.
- The TrueNAS REST API was deprecated in TrueNAS 25.04. Full removal of the REST API is planned for TrueNAS 26.04.
TrueNAS (25.04 and later) uses a versioned JSON-RPC 2.0 over WebSocket API. API versions are numbered in conjunction with TrueNAS version releases.
The API documentation provides information about supported API methods and events. Documentation is included for all API versions supported by the current TrueNAS release and defaults to the latest supported API. Use the dropdown to view documentation for different supported API versions.
Advanced users can interact with the TrueNAS API to perform management tasks using the TrueNAS API Client as an alternative to the TrueNAS web UI. This websocket client provides the command line tool
midcltand allows users to communicate with middleware using Python by making API calls. The client can connect to the local TrueNAS instance or to a specified remote socket.You can access TrueNAS API documentation in the web interface by clicking laptop My API Keys on the top right toolbar account_circle user settings dropdown menu to open the User API Keys screen. Click API Docs to view API documentation.
NVIDIA GPU Compatibility: TrueNAS 25.10 switches to open GPU kernel drivers that are incompatible with legacy NVIDIA GPUs (Pascal, Maxwell, Volta architectures). See NVIDIA GPU Support for compatibility details.
Virtual Machine Startup Changes: VMs created in TrueNAS 25.04 (pre-25.04.2) and displayed on the Containers screen no longer automatically start on system boot to prevent conflicts with VMs on the Virtual Machines screen. See Containers and Virtual Machines for more information.
Active Directory AUTORID IDMAP Backend Removal: TrueNAS 25.10 removes this option to improve consistency across multi-server environments (NAS-136630). Existing configurations using AUTORID are automatically migrated to RID during upgrade. Users should review their ACLs and permissions after upgrade and might need to reconfigure them in some edge cases.
TrueNAS 25.10 removes the built-in SMART test scheduling and monitoring interface to improve user flexibility for disk monitoring. The smartmontools binaries remain installed and continue to be used internally by TrueNAS, ensuring that existing third-party scripts and monitoring tools will work unchanged. Users seeking advanced SMART monitoring can install the “Scrutiny” app from the TrueNAS catalog, which offers superior disk health tracking with historical data storage, customizable alerts, and automatic drive detection. TrueNAS maintains monitoring of critical disk health indicators and automatically migrates existing scheduled SMART tests to cron tasks during upgrade.
TrueNAS 25.10 removes the Certificate Authority (CA) functionality that allowed TrueNAS to create and sign certificates. Users can continue to manage certificates by creating Certificate Signing Requests (CSRs) to be signed by external certificate authorities or and importing certificates that have been signed by external CAs or directory services. These alternatives provide the certificate management capabilities most users need while ensuring proper certificate validation through established certificate authorities.
Virtual Machines are now “Enterprise ready” with support for TrueNAS Enterprise High Availability (HA) systems and failover (NAS-136509).
The Enable Secure Boot option is added to virtual machine configuration screens (NAS-136466).
Virtual machines created in 25.04 (pre-25.04.2) and displayed on the Containers screen do not automatically start on system boot to prevent conflicts with VMs on the Virtual Machines screen that might use the same zvol(s) (NAS-136946).\
Resolves ZFS ARC memory management conflicts that were causing out-of-memory crashes in Virtual Machines due to memory fragmentation issues (NAS-135499).
Application maintenance, including version updates, features, and configuration options, is independent from TrueNAS version release cycles.
See documentation and resources at the TrueNAS Apps Market and the truenas/apps repository issues tracker for more information.
- TrueNAS 25.10 adds an option to automatically migrate existing applications when changing apps pool locations (NAS-135720). See Migrating Existing Applications for details.
- 25.10 supports configuring external container registry mirrors as alternative sources for Docker images (NAS-136553). See PD-2125 for more information.
- Includes the NVIDIA open GPU kernel module drivers. These drivers work with Turing and later GPUs. Earlier architectures (Pascal, Maxwell, Volta) are not compatible. See NVIDIA GPU Support for more information.
- Fixes the NVIDIA GPU related error “RenderError: Expected [uuid] to be set for GPU in slot” (NAS-134152).
- Fixes a bug to reenable available update notifications for custom apps (NAS-135124).
TrueNAS 25.10 introduces support for NVIDIA open GPU kernel module drivers, enabling compatibility with the latest NVIDIA graphics cards including the newest Blackwell architecture. This driver update ensures support for modern GPU acceleration workloads in TrueNAS Apps and Containers.
The open GPU kernel drivers are compatible with Turing architecture and later GPUs, which includes GTX 16-series cards and all RTX series cards. The new NVIDIA Blackwell (RTX 50-series) chips require the nvidia-open driver to function, as this driver leverages the built-in NVIDIA GSP (GPU System Processor).
Users with compatible hardware can enable TrueNAS to install NVIDIA drivers. See the TrueNAS Apps Market for installation instructions.
GPUs based on earlier architectures including Pascal (GTX 10-series, Quadro P-series), Maxwell (GTX 700 and 900-series), and Volta (GTX Titan V) are not supported by the NVIDIA open drivers. This is because these older GPUs lack the required GSP component.
Users with incompatible legacy cards can still utilize them by deploying a TrueNAS Virtual Machine and isolating the GPU to it. This approach involves creating a VM, isolating the legacy GPU to that VM, installing the proprietary NVIDIA driver within the VM environment, and running GPU workloads from within the virtual machine. However, this workaround requires a secondary GPU (such as integrated Intel graphics or IPMI console) to handle system display duties, as isolating the only GPU in the system would leave TrueNAS without console access.
Early releases of a major version are intended for testing and feedback purposes only. Do not use early release software for critical tasks.
Upgrading to TrueNAS 25.10 (Goldeye) from an earlier TrueNAS release is primarily done using the web interface update process. Another upgrade option is to use a TrueNAS .iso file to perform a fresh install on the system and then restore a system configuration file.
Update to the latest maintenance release of the current major version before upgrading to the next major version. You can then upgrade directly from the latest maintenance release to the latest release of the next major version.
This chart shows the basic upgrade paths between TrueNAS major versions. Depending on your use case and risk tolerance, you may prefer to delay upgrading to allow additional time for testing and stability. See the TrueNAS Software Status for version recommendations tailored to different user types from Developer to Mission Critical.
flowchart LR
A["11.3-U5"] -->|update| B["12.0-U8.1"]
B -->|"update / ISO install"| C["13.0-U6.8 / 13.3-U2"]
C -->|update| G
C -->|ISO install| I
D["22.02.4 (Angelfish)"] -->|update| E
E["22.12.4.2 (Bluefin)"] -->|update| F
F["23.10.2 (Cobia)"] -->|update| G
G["24.04.2.5 (Dragonfish)"] -->|update| H
H["24.10.2.4 (Electric Eel)"] -->|update| I
I["25.04.2.3 (Fangtooth)"] -->|"(anticipated)"| J
J["25.10 (Goldeye)"]
flowchart LR
A["11.3-U5"] -->|update| B
B["12.0-U8.1"] -->|update| C
C["13.0-U6.8"] -->|ISO install| G
C -->|update| E
D["23.10.2 (Cobia)"] -->|update| E
E["24.04.2.5 (Dragonfish)"] -->|update| F
F["24.10.2.4 (Electric Eel)"] -->|update| G
G["25.04.2.3 (Fangtooth)"] -->|"(anticipated)"| H
H["25.10 (Goldeye)"]
Permitted upgrade methods are:
- update: Apply updates using the Update screen in the TrueNAS UI or install a manual update file. Not all upgrade paths support automatic updates (see chart).
- ISO install: Save your TrueNAS configuration file, perform a fresh install using an .iso file for the target version, then upload the saved configuration.
You can skip major versions using a fresh installation with configuration file restore. Before skipping versions, review release notes for each major version to identify service deprecations or significant changes that may affect your configuration. Consider upgrading incrementally through major versions with significant changes, or be prepared to manually reconfigure any incompatibilities after upgrading directly to the target version.
Migrating TrueNAS from FreeBSD- to Linux-based versions is a one-way operation. Attempting to activate or roll back to a FreeBSD-based TrueNAS boot environment can break the system.
Upgrade your FreeBSD-based TrueNAS system to the latest publicly-available release version, 13.0-U6.7 (or 13.3-U1.2 for community users), before attempting to migrate. See Software Releases for current recommended update paths to make sure you download and migrate to the correct version.
Depending on the specific system configuration, migrating from a FreeBSD-based TrueNAS version can be a straightforward or complicated process. See the Migration articles for cautions and notes about differences between each software and the migration process.
TrueNAS Enterprise customers with High Availability (HA) or Non-HA TrueNAS Hardware should consult with TrueNAS Enterprise Support for assistance before attempting to migrate.
Customers who purchase TrueNAS hardware or that want additional support must have a support contract to use TrueNAS Support Services. The TrueNAS Community forums provides free support for users without a TrueNAS Support contract.
TrueNAS Customer Support Support Portal https://support.ixsystems.com support@ixsystems.com Telephone and Other Resources https://www.ixsystems.com/support/
Click the component version number to see release notes for that component.
| 25.10-BETA.1 | |
|---|---|
| Linux Kernel | 6.12.33 |
| OpenZFS | 2.3.3 |
| Docker Engine | 28.3.1 |
| NVIDIA Driver | 570.172.08 |
*TrueNAS 25.10 and later includes the NVIDIA open GPU kernel module drivers. These drivers work with Turing and later GPUs. Earlier architectures (Pascal, Maxwell, Volta) are not compatible. See NVIDIA GPU Support for more information.
TrueNAS integrates many features provided by the upstream OpenZFS project. Any new feature flags introduced since the previous OpenZFS version that was integrated into TrueNAS (OpenZFS 2.3.0) are listed below:
For more details on feature flags, see OpenZFS Feature Flags and OpenZFS zpool-feature.7.
Have more questions?
For further discussion or assistance, see these resources:
- TrueNAS Community Forum
- TrueNAS Community Discord
- TrueNAS Enterprise Support (requires paid support contract)
Found content that needs an update? You can suggest content changes directly! To request changes to this content, click the Feedback button located on the middle-right side of the page (might require disabling ad blocking plugins).